TED External Transfer

A TED transfer is very similar to a Pix transfer with bank account details, but it uses a different system and will only be processed on business days until 17:00 BRT time

Request

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers/ted

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers/ted' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--header 'IdempotencyKey: {{guid}}' \
--data '{
  "amount": 0.01,
  "description": "test",
  "beneficiary": {
    "participantIspb": "00000000",
    "branch": "0001",
    "holder": {
      "document": "12345678901",
      "email": "[email protected]",
      "name": "Teste da Silva"
    },
    "number": "210001953"
  }
}'

Headers

Name	Description
x-delbank-api-key	Required. API key
x-delfinance-account-id	Required. The Delfinance bank account number
IdempotencyKey	Required. Request's idempotency key. Provide a GUID, being a new one for each request..

Body

Name	Type	Description
bankAccountPayer	string	Bank account that will be making the payment.
amount	number	Required. Transfer amount.
description	string	Description about the transfer, internal use only
beneficiary	object	Required. Object containing information on the transaction beneficiary
participantIspb	string	Required. ISPB code of the beneficiary client bank account.
branch	string	Required. Beneficiary account branch
number	string	Required. The account number
holder	object	Required. Object containing information about the beneficiary account holder
document	string	Required. Beneficiary account holder CPF or CNPJ
email	string	Required. Beneficiary account holder e-mail
name	string	Required. Beneficiary account holder full name
type	enum	Required. Beneficiary's account type ( CURRENT,SAVING,SALARY,PAYMENT )

Note

🚧 The bankAccountPayer field is only required if the payer account is different from the authenticated account. If this field is provided, the transfer can only be executed if the authenticated account owns the payer account’s branch and has the necessary permissions.

Response

The status code 200 will indicate success in the transaction.

Being successful, the return will bring the following fields in JSON format:

Note

🚧 This information will be returned after the transfer creation and transfer query.

{
    "id": "{id}",
    "status": "DONE",
    "type": "TED",
    "amount": 0.01,
    "createdAt": "2025-02-10T12:48:20.695Z",
    "description": "Test",
    "payer": {
        "number": "{payer_account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    },
    "beneficiary": {
        "number": "{account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    }
}